home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / A / AOL DM Assist.cpt / AOL DM Assist / AOL DM Assist.README < prev    next >
Encoding:
Text File  |  1992-08-18  |  9.0 KB  |  120 lines  |  [TEXT/MSWD]
  1. America Online Download Manager Assistant (AOL DM Assist) 1.0b3
  2. ©1992, Dave Martin (America Online ©1992, America Online, Inc.)
  3. 5101 Leonard Road #77
  4. Bryan, Texas 77803
  5.  
  6. August 17, 1992 - 1.0b3
  7.  
  8. This is the third beta version of AOL DM Assist, an unofficial External Tool for use with the America Online 2.0 software for the Mac. AOL DM Assist is a tool which provides many features lacking in the new Download Manager. It does not replace DM, it enhances it & complements it. Many of these features are ones that I hope to see AOL add to the Download Manager in later releases of the File Transfer Tool (though I now appreciate the work which would be involved in getting these in there). Until then, I've created this. It does not modify, in any way, the America Online program or any of its Tools. The only AOL-related file which this program affects is the Mailbox files (as selected by the user). I have checked with both a member of AOL's Mac Development team and with the TOS Advisor and have been told that there should be no problem distributing this (I wanted to be certain since I knew that they would not allow Andrew Welch's AOL Aid INIT to be distributed online - since this app doesn't affect the operation of the AOL software, it's ok).
  9.  
  10. It is important when using AOL DM Assist to remember to ALWAYS work with a COPY of your mail file, especially with the pre-final versions. AOL DM Assist opens the resource file to read in the DM data, then closes the file again. It does not open it again until it saves changes. This should reduce the chances of file corruption, but it does not guarantee it. If an error should occur while writing the file (or possibly even when reading the file), the odds are against the file surviving. While it is not impossible to use this utility while AOL 2.0 is running – online or off – it is strongly discouraged. AOL 2.0 does seem to follow the same routine with the resource file as I do (open only when reading or writing), but since the file holds both the download queue data and any incoming or outgoing mail messages, it would be advised to not try this. I have looked for, but have not yet found, a way to check the other processes and automatically exit if AOL 2.0 is running (at least, a way which works under System 6.x).
  11.  
  12. This utility has been tested on a Mac IIsi / System 7.0.1 + Tuner 1.1.1 / 32-bit Add ON with tons of extensions active during the development (best way to crash-test!) in addition to the systems used by my four alphans and the dozen or so betas (thanks, guys!). I'm currently uncertain whether this utility works reliably on 68000 compact Macs (SE, Classic) or on Macs running System 7.x in 24-bit mode. Since the files being opened are owned by AOL 2.0, AOL DM Assist does support drag-and-drop opening under System 7.x, though it should run without any problems under 6.x.
  13.  
  14. If you have any problems or bug reports, please direct them to me (with system config info). This is my first attempt at Macintosh (and Pascal) programming, so I can't certify that I'll know where to begin to correct the reported problems, but I'll do what I can.
  15.  
  16. Dave Martin (DBM)
  17. -------------------------------------------------------------
  18. Current working features are:
  19.  
  20. •  Opens the selected AOL Mail file, and reads in the Download 
  21.    Manager queue data. There are two queues that DM uses — the list 
  22.    of files left to download (including those partially transferred) 
  23.    and the list of files which have been completed. AOL DM Assist 
  24.    adds a third queue, which does not interfere with the other 
  25.    queues — a holding queue, for setting aside files which you don't 
  26.    wish to download at this time.
  27.  
  28. •  You can shift queue entries up or down the list (multiple, 
  29.    discontinuous selections supported, including Select All).
  30.  
  31. •  Move entries to the Holding Queue for later downloading, and back
  32.    again into the Download Queue. Again, this works with multiple
  33.    selections.
  34.  
  35. •  Delete individual (or multiple, discontinuous) rows. Easy 
  36.    clean-up of the completed download list — just Select All and 
  37.    then delete.
  38.  
  39. •  You can do a Get Info on an individual entry for more details (file
  40.     size, location of partial file, etc.). You can edit the local filename for
  41.     a partially or completely downloaded file, and their file types/creators.
  42.     *Note that changing the local name of a file or its type/creator will force a
  43.        save of all changes made to the queues.
  44.  
  45. •  You can also Rename a local filename by a separate command.
  46.     *Note that changing the local name of a file will force a
  47.        save of all changes made to the queues.
  48.  
  49. •  Set Preferences via a dialog within the utility. Prefs currently include
  50.     whether to show the About box at launch, whether to prompt for a file
  51.     to open at launch, and whether to calculated estimated download times
  52.     based on 2400 baud. Settings are saved within the app.
  53. -------------------------------------------------------------
  54. Planned features:
  55.  
  56. •  Ability to print any or all of the three queue listings (Maybe).
  57.  
  58. •  Allow setting of the default download folder (and optionally move
  59.    any partially-transferred files from the old folder to the new).
  60.  
  61. •  Let the user reset a partially downloaded file to zero. This would
  62.    delete the partial file and set the queue information for that
  63.    entry to indicate that the file has not been transferred at all.
  64.    This would fix files which are cancelled before the File Manager
  65.    creates the file - AOL's DM insists the file exists and chokes
  66.    when it can't locate it.
  67.  
  68. •  Ability to move a partial file to a new location (and update its 
  69.    queue entry), or reattach a partial file with its entry.
  70. -------------------------------------------------------------
  71. Known Problems:
  72.  
  73. •  The Close menu item is disabled, since on occasion the program 
  74.     will crash if you close a file then open another file. It seems to 
  75.     be a memory-related problem, which I'm looking in to. Even when 
  76.     enabled, though, the Close menu item is dimmed (though it is 
  77.     selectable) — I have yet to find an explanation for that, unless it 
  78.     is related to the fact that the windows do not have close boxes 
  79.     (it's easier to manage three windows which contain lists that are 
  80.     guaranteed to always be open than to allow them to be closed).
  81. -------------------------------------------------------------
  82. America Online Download Manager Assistant will be true SHAREware when finally
  83. released – you are under no obligation to pay for it or for using it. It will not be
  84. crippled or "hexadecimally challenged". When completed, I plan to freely SHARE this utility with any AOL member who wants it. In fact, any AOL member who cares to may keep it, without owing me anything, not even a postcard. I want to put the SHARE back into SHAREware. (Of course, I won't turn down any cash offerings if anyone cares to SHARE theirs with me :).
  85. -------------------------------------------------------------
  86. Changes since 1.0b2:
  87.   * Fixed the problem with the automatic save when using the Rename command.
  88.   * Modified code to use some OOP.
  89.   * Added the Preferences dialog for more easily editing the Pref settings.
  90.   * Included in a separate file the ResEdit TMPLs for the 'FilQ' resource.
  91.  
  92. Changes since 1.0b1:
  93.   * Modified the code to improve dialog management.
  94.  
  95. Changes since 1.0a2:
  96.   * Rearranged the menu items a bit, and marked those which are planned with a green
  97.       bullet. While these were marked before, the bullet had been part of the menu item
  98.       name, rather than as a checkmark character.
  99.   * Added two menu items to the Download List menu: '1200 Baud' and '2400 Baud'. This
  100.       allows you to select the baud rate that is used to estimate the time remaining for an
  101.       untransferred or partially-transferred file. (The estimated time was added to the
  102.       listings in 1.0a2, but it was not clearly indicated and was based on 2400 baud. The
  103.       ETR is now in the form 'x.x min', and changes depending on the setting. When AOL
  104.       implements 9600 baud, and if I can get the general data from someone with 9600
  105.       baud access, I will add that option).
  106.   * Added a preferences resource to the utility ('PreF', ID=128) with a ResEdit TMPL
  107.       for editing it. At the moment, there are three prefs, each a boolean (0=false, 
  108.       1=true) to indicate what the program will do:
  109.       - PrefdoAbout: TRUE = show About box at application launch.
  110.       - PrefdoOpen: TRUE = request file to open at launch.
  111.       - PrefBaud2400: TRUE = calculate ETR at 2400 baud, FALSE = calc at 1200.
  112.       Eventually I will add in the ability to set the Prefs from within the app, as well as
  113.       remembering whether you have the 1200 or 2400 baud menu item checked.
  114.   * I now check to see if the WaitNextEvent trap is available and use it if it's there, only
  115.       using GetNextEvent if WNE is not present. I currently have the idle at 60 ticks, so
  116.       let me know if it's not giving enough time to background processes, or not getting
  117.       enough for itself.
  118.   * Added the Rename command and the ability to change the name by editing the local
  119.      filename in the Get Info window (this does not work perfectly, see above).
  120.